home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 035a / dxer133.zip / DXER133.DOC < prev    next >
Text File  |  1991-01-10  |  13KB  |  296 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                 The DXer
  12.  
  13.                                 By WA6JOO
  14.  
  15.                            19279 Santa Ana Ave
  16.                           Bloomington, CA   92316
  17.  
  18.                                  (c)1990
  19.  
  20.  
  21.  
  22.      i. Release History
  23.  
  24.      Version 1.0         Initial Release
  25.  
  26.      Version 1.1         Fixed a few small bugs.  Program now works
  27.                          correctly with Monochrome monitors.
  28.  
  29.      Version 1.3         Fixed minor bugs in menuing system and FOT
  30.      9/3/90              calculations.  MUF and grayline functions run
  31.                          MUCH faster (approx twice as fast on MUF, ten
  32.                          times as fast on Gray Line). You may now
  33.                          choose either six digit (Maidenhead) or four
  34.                          digit Grid Square designations.  This is done
  35.                          in the initial config. setup.
  36.  
  37.      Version 1.31        Fixed really dumb bug in grid locator function
  38.      11/3/90             when using six digit designations.
  39.  
  40.      Version 1.32        Fixed even dumber bug in bearing-distance
  41.      11/16/90            function.  Where do these things come from?                                            
  42.  
  43.      Version 1.33        Another bug. This one properly belongs to 
  44.      1/11/91             MicroSoft and QuickBasic 4.5. Prevented
  45.                          correct printing of custom bearing-distance
  46.                          Tables. Also minor optimizing speeds up MUF
  47.                          and Sunrise/set calculations by 10 to 15 percent.
  48.  
  49. 1. Introduction
  50.  
  51.      The DXer concentrates several functions of interest to the
  52. serious DXer into one (hopefully) easy-to-use program.
  53.  
  54.           A:   Bearing and Distance from Transmitter to Receiver. 
  55.                Path ends may be selected by Lat-Lon, Grid Square,
  56.                Prefix, or by browsing through the data base.
  57.  
  58.           B:   Sunrise and Sunset times for any location
  59.  
  60.           C:   Maximum Usable Frequency and Frequency of Optimum
  61.                Traffic between any two locations.
  62.  
  63.           D:   A listing of all locations sharing a common terminator
  64.                line (Gray Line).
  65.  
  66.           E:   Prints custom bearing/distance charts for any location.
  67.  
  68.           F:   A grid locator function using either six digit or four
  69.                digit coordinate system.
  70.  
  71.           E:   A complete data base of all ARRL countries as well as
  72.                other locations around the world.  The data base shows
  73.                latitude, longitude,  continent and CQ zone of each
  74.                location.  Entries may be easily added, deleted or
  75.                edited.
  76.  
  77. 2.  SYSTEM REQUIREMENTS
  78.  
  79.           IBM PC, XT, AT or close clone with 384k minimum memory.  A
  80.           math coprocessor is highly recommended although not
  81.           required.  If you have no coprocessor, be prepared to wait
  82.           several seconds for the Gray Line and MUF calculations.
  83.  
  84.           Monochrome, CGA, EGA, VGA monitor.  You may have some
  85.           readability difficulties if you use a composite b/w monitor
  86.           with a color board, since there is no way to disable color
  87.           with this combination.
  88.  
  89.           One 360K floppy drive.  All data is kept in memory so,
  90.           except when loading or modifying the data base, there is no
  91.           real advantage to a hard disk.  If you have one, by all
  92.           means use it.
  93.  
  94.           This program was developed on an 8MHz IBM AT and a 10MHz
  95.           clone.  The program has been tested on an IBM XT with mono
  96.           and CGA monitor, 8MHz, 10MHz, 12Mhz and 16 MHz '286 machines
  97.           with EGA and VGA, and a 16 MHz '386SX with VGA with no
  98.           problems.  It obviously runs a lot faster on fast machines.
  99.           There is no machine specific code in the program so it
  100.           should run on any 100% BIOS compatible.
  101.  
  102.  
  103.           A Printer is not required but, if available, many of the
  104.           data tables may be printed.
  105.  
  106. 3.  GENERAL
  107.  
  108.           The program is written in MicroSoft QuickBasic 4.0/4.5 with
  109.           a few routines in assembler and contains approximately 3000
  110.           lines of code.  The algorithms used in some of the
  111.           calculations were extracted from many sources and I make no
  112.           claim of originality for them except for the implementation
  113.           in QuickBasic.
  114.  
  115.           The program was written for my own use and to become
  116.           proficient in the QuickBasic language and represents
  117.           literally hundreds of hours of programming time.  I am
  118.           releasing the program into the public domain for individual
  119.           use and enjoyment only!  Permission for any commercial use
  120.           is expressly denied.
  121.  
  122.           Please feel free to upload or otherwise distribute copies of
  123.           The DXer. If you find this program to be useful, a small
  124.           ($10 or so) donation would be appreciated, however, if you
  125.           choose not to make a donation,  go ahead and use the program
  126.           with a clear conscience. I doubt if I'll lose any sleep over
  127.           it.
  128.  
  129. 4.  PROGRAM DESCRIPTION
  130.  
  131.           The program is completely menu driven and is generally self
  132.           explanatory.  A couple of items to remember:
  133.  
  134.      a:   When entering latitudes and longitudes, use decimal degrees,
  135.           not dd,mm,ss format.  Precede latitudes south of the equator
  136.           with a minus(-) sign.  Precede longitudes east of Greenwich
  137.           with a minus(-) sign.
  138.  
  139.      b:   When running the program for the first time, you will be
  140.           prompted to create a Configuration file.  You will need to
  141.           know the Latitude and Longitude of your station, the
  142.           formfeed code (decimal) for your printer, and your summer
  143.           time change system to create the config file.  Once the file
  144.           has been created, it may be changed at any time from the
  145.           FILE UTILITIES menu.
  146.  
  147.           If no printer is available, the BEARING TABLE function will
  148.           not show on the main menu and the print function will not
  149.           show on the PROPAGATION FORECAST and SUNRISE-SUNSET
  150.           selections.
  151.  
  152.      c:   Two copies of the database file and the configuration file
  153.           are maintained by the program.  If the main file is damaged,
  154.           simply go into DOS and rename the main file to some other
  155.           name then rename the backup file to the primary name.  The
  156.           program will create a new backup file.
  157.  
  158.      d:   When running the program, the active keys are shown at the
  159.           bottom of the screen.  Pressing an inactive key will
  160.           generate a beep from the computer.
  161.      e:   A moderate amount of error checking is done on any user
  162.           input although some types of errors are impossible to trap. 
  163.           If you make a mistake on entry, use the backspace key to
  164.           edit.
  165.  
  166.      f:   From any menu, use the up and down cursor keys to move the
  167.           highlite bar.  Press the Enter key to select.
  168.  
  169.      g:   The Escape key will always back up to the previous logical
  170.           page.
  171.  
  172.      h.   The program reads the system clock for local time and
  173.           converts to UTC as required for calculations.  If you don't
  174.           have a real-time clock be sure to set your system clock
  175.           using the DOS Time and Date functions before running the
  176.           DXer.  The Program recognizes Daylight Savings Time and
  177.           European Summer Time.  DST begins on the first Sunday in
  178.           April and Ends on the last Sunday in October.  EST begins on
  179.           the last Sunday in March and ends on the last Sunday in
  180.           September.  If your location does not observe one of these
  181.           time changes, enter "N" at the appropriate prompt when
  182.           creating your Config. file.  If some other time schedule is
  183.           observed at your QTH, you will have to make your own
  184.           correction by resetting your system clock.
  185.  
  186. 5.  MENU DESCRIPTIONS
  187.  
  188.      A:  BEARING-DISTANCE
  189.  
  190.           Shows both short and long path bearings and distances from a
  191.           transmitter location (most often your home QTH) and a
  192.           receiver location.  The receiver location may be specified
  193.           by prefix, latitude/longitude, grid square, or chosen from
  194.           the data base.
  195.  
  196.           When selecting by prefix, all locations with a common prefix
  197.           will be shown.  When searching for a prefix common to many
  198.           countries (i.e. VK), use the (C)ontinue Search key until you
  199.           find what you are looking for or exhaust all entries in the
  200.           data base.
  201.  
  202.           When using the Select option, you will see the whole
  203.           database in tabular form.  Use the cursor movement keys to
  204.           browse through until you find the desired entry.  Press the
  205.           Enter key to select.
  206.  
  207.      B:  PROPAGATION FORECAST
  208.  
  209.           Transmitter and receiver locations are selected as above. 
  210.           MUF calculations are by the MiniMUF '85 algorithm with an
  211.           initial hop length of 4000km.  Actual hop length and number
  212.           of hops are changed by the program so that the path between
  213.           transmitter and receiver is an even number of hops.  Since a
  214.           4000km hop length is very difficult to achieve due to the
  215.           extremely low radiation angle required, the program will not
  216.           extend the hop length beyond 4000km for calculations.
  217.  
  218.           The FOT calculations are based on the calculated MUF with
  219.           corrections based on absolute sunspot number, UTC time, and
  220.           season.  FOT will generally be somewhere between 80 and 90%
  221.           of MUF.
  222.  
  223.           The calculated values from the program have been checked
  224.           against the output from several other programs available in
  225.           the public domain as well as the propagation curves
  226.           published monthly in QST.  The plotted curves are in general
  227.           agreement although I have not observed point by point
  228.           agreement between any two programs.  The output from The
  229.           DXer seems to agree reasonably well with observed
  230.           propagation conditions on the bands.
  231.  
  232.           Since the ionosphere has a long time constant, a 5 to 10 day
  233.           smoothed (average) solar flux number will generally give
  234.           more believable numbers.  No allowance is made for disturbed
  235.           conditions since I have yet to see an algorithm to do this. 
  236.           If I ever find one, I will certainly add it to the program.
  237.  
  238.           The radial MUF calculations are from a transmitter location
  239.           to receiver locations at a given distance from the
  240.           transmitter on bearings from 0 to 350 degrees from the
  241.           transmitter.  Maximum number of hops is 5 (20000km).
  242.  
  243.      C:  SUNRISE-SUNSET TABLE
  244.  
  245.           Calculates sunrise and sunset times for the selected
  246.           location over any one month period.  The first calculation
  247.           is always for the current month.
  248.  
  249.      D: GRAY LINE
  250.  
  251.           Calculates sunrise and sunset for all locations in the data
  252.           base and displays those locations whose sunrise or sunset is
  253.           within plus or minus one-half hour of the transmitter
  254.           location sunrise or sunset.
  255.  
  256.      E:  BEARING TABLE
  257.  
  258.           If you have a printer this routine will print a custom
  259.           bearing-distance table from any location to all locations in
  260.           the data base.  The printout will be in Prefix order and
  261.           includes all countries on the ARRL DXCC countries list as
  262.           well as any other location that you include in the data
  263.           base.
  264.  
  265.      F:  GRID LOCATOR
  266.  
  267.           This function is mainly useful by you VHF types out there. 
  268.           Grid coordinates use either the six digit Maidenhead system
  269.           (i.e. DM14AA) as described in the RSGB VHF handbook or the
  270.           four digit system (i.e. DM14) more commonly used in the
  271.           states.  You may identify a grid square by entering the
  272.           latitude and longitude or may enter the grid square and
  273.           calculate latitude and longitude in which case the returned
  274.           values will be the center of the specified grid square.  If
  275.           the entered coordinates should fall on the dividing line
  276.           between two or more squares, the identification will default
  277.           to the square to the north and/or west of the entered
  278.           location.
  279.  
  280.      G:  FILE UTILITIES
  281.  
  282.           Allows you to maintain the data base.  You may add new
  283.           records, delete records, or edit existing records.  If you
  284.           change the data base in any way, the unchanged version is
  285.           saved as the backup file on disk.  The data base is
  286.           maintained in order sorted by prefix.
  287.  
  288.           This function also allows creation of the configuration
  289.           file. The config file contains your home latitude and
  290.           longitude, preferred grid square system,  summer time change
  291.           system, and your printer formfeed code.
  292.  
  293. Well, that's about it.  I've pretty well debugged the code but there
  294. is no such thing as a bug free program if it contains more than a few
  295. lines of code.  If you find any significant bugs, drop me a note on
  296. the back of a QSL and I'll fix it.